IdProo
IdProo Docs

Modul: Master Data — Applications — Regencies
Versi 1.0
Tanggal 20 April 2026
Aplikasi IdProo Admin
Audiens Administrator

Dalam artikel ini

  1. Menampilkan Daftar Regencies
  2. Menambahkan Regency
  3. Mencari Regency
  4. Preview Informasi Regency
  5. Mengubah Regency
  6. Menghapus Regency
  7. Import / Export Regency
  8. Ringkasan Alur
  9. Solusi dan Tindakan Selanjutnya

1. Menampilkan Daftar Regencies

Halaman Regencies dapat diakses melalui navigasi: Master → Applications → Regencies.

Halaman ini menampilkan daftar seluruh kabupaten/kota yang telah terdaftar dalam sistem.

screenshot-278-regencies-list

Gambar 1: Halaman Regencies menampilkan daftar kabupaten/kota dengan kolom Name, Province, dan Created at.

Kolom yang tersedia pada tabel Regencies:

Kolom Keterangan
Name Nama kabupaten/kota yang dapat diklik untuk melihat detail informasi
Province Nama provinsi tempat kabupaten/kota berada
Created at Tanggal dan waktu data kabupaten/kota dibuat

Saat kursor diarahkan ke baris regency, ikon Edit (✏) dan Delete (🗑) akan muncul di sebelah kanan baris tersebut.

2. Menambahkan Regency

Untuk menambahkan kabupaten/kota baru, klik tombol + New regency di pojok kiri atas tabel.

screenshot-279-new-regency-button

Gambar 2: Tombol + New regency untuk menambahkan kabupaten/kota baru.

Panel Create new regency akan terbuka di sisi kanan layar dengan form yang perlu diisi.

screenshot-280-create-regency-panel

Gambar 3: Panel Create new regency dengan field Name dan dropdown Province, serta tombol Save dan Cancel.

Form Create new regency terdiri dari:

Field Keterangan
Name Nama kabupaten/kota (wajib diisi)
Province Dropdown untuk memilih provinsi tempat kabupaten/kota berada (wajib diisi)

Langkah-langkah menambahkan regency:

  1. Klik tombol + New regency.
  2. Isi field Name dengan nama kabupaten/kota.
  3. Pilih Province dari dropdown yang tersedia.
  4. Klik Save untuk menyimpan data.
screenshot-281-regency-saved-success

Gambar 4: Notifikasi "Data saved successfully" muncul setelah data kabupaten/kota berhasil disimpan.

Tips: Klik Cancel untuk membatalkan penambahan regency dan menutup panel tanpa menyimpan perubahan.

3. Mencari Regency

Search bar di pojok kanan atas tabel digunakan untuk mencari kabupaten/kota berdasarkan nama.

screenshot-282-search-regency

Gambar 5: Pencarian dengan kata kunci "kota baru" memfilter daftar dan menampilkan hasil yang cocok (1 - 1 of 1).

Catatan: Pencarian bersifat dinamis — daftar akan diperbarui seiring pengetikan. Klik ikon × di sebelah kanan kolom pencarian untuk menghapus filter dan menampilkan kembali seluruh daftar kabupaten/kota.

4. Preview Informasi Regency

Administrator dapat melihat detail informasi kabupaten/kota dengan mengklik nama regency pada daftar.

screenshot-283-hover-regency-name

Gambar 6: Arahkan kursor ke baris regency; ikon Edit dan Delete muncul di sisi kanan baris.

Panel detail akan terbuka di sisi kanan layar dan menampilkan informasi lengkap kabupaten/kota.

screenshot-284-regency-detail-panel

Gambar 7: Panel detail Regency menampilkan ID, Province, Created at, Created by, Last modified, Last modified by, dan tombol Close.

Informasi yang ditampilkan pada panel detail:

Informasi Keterangan
ID Identifikasi unik kabupaten/kota dalam sistem
Province Provinsi tempat kabupaten/kota berada
Created at Tanggal dan waktu data kabupaten/kota dibuat
Created by Akun yang membuat data beserta alamat email
Last modified Tanggal dan waktu terakhir data diubah
Last modified by Akun yang terakhir mengubah data beserta alamat email

Klik tombol Close untuk menutup panel detail.

5. Mengubah Regency

Untuk mengubah data kabupaten/kota yang sudah ada, arahkan kursor ke baris regency yang ingin diubah, lalu klik ikon Edit (✏) yang muncul di sebelah kanan baris.

screenshot-285-edit-button-tooltip

Gambar 8: Tooltip "Edit" muncul saat kursor diarahkan ke ikon Edit (✏) pada baris regency.

Panel Edit regency akan terbuka di sisi kanan layar dengan data kabupaten/kota yang sudah ada, siap untuk diubah.

screenshot-286-edit-regency-panel

Gambar 9: Panel Edit regency menampilkan field yang sama dengan Create, berisi data kabupaten/kota yang sudah ada.

Langkah-langkah mengubah regency:

  1. Arahkan kursor ke baris regency yang ingin diubah.
  2. Klik ikon ✏ (Edit) yang muncul di sisi kanan baris.
  3. Ubah field yang diperlukan (Name atau Province).
  4. Klik Save untuk menyimpan perubahan.

Catatan: Struktur panel Edit regency identik dengan panel Create new regency, meliputi field Name dan dropdown Province.

6. Menghapus Regency

6.1 Menghapus Satu Regency

Untuk menghapus satu kabupaten/kota, arahkan kursor ke baris regency yang ingin dihapus, lalu klik ikon Delete (🗑) yang muncul di sebelah kanan baris.

screenshot-287-delete-button-tooltip

Gambar 10: Tooltip "Delete" muncul saat kursor diarahkan ke ikon Delete (🗑) pada baris regency.

Dialog konfirmasi Delete Regencies akan muncul. Klik Delete (merah) untuk mengonfirmasi penghapusan, atau Cancel untuk membatalkan.

6.2 Menghapus Beberapa Regency Sekaligus

Untuk menghapus lebih dari satu kabupaten/kota sekaligus, gunakan checkbox pada setiap baris.

screenshot-288-bulk-select-checkboxes

Gambar 11: Centang checkbox pada setiap baris yang ingin dihapus. Tombol "Delete item (N)" muncul di toolbar atas.

Langkah-langkah menghapus beberapa regency:

  1. Centang checkbox di sebelah kiri setiap kabupaten/kota yang ingin dihapus.
  2. Tombol Delete item (N) akan muncul di toolbar atas, di mana N adalah jumlah item yang dipilih.
  3. Klik tombol Delete item (N).

Dialog konfirmasi Delete Regencies akan muncul.

screenshot-289-delete-confirmation-dialog

Gambar 12: Dialog konfirmasi "Are you sure to delete this Regencies?" sebelum penghapusan dieksekusi.

  1. Klik Delete untuk mengonfirmasi, atau Cancel untuk membatalkan.

⚠️ Perhatian: Penghapusan kabupaten/kota bersifat permanen dan tidak dapat dibatalkan. Pastikan regency yang dipilih sudah benar sebelum mengklik Delete.

7. Import / Export Regency

Fitur Import dan Export dapat diakses melalui menu ⋯ OPTION di pojok kanan atas tabel.

screenshot-290-option-menu-button

Gambar 13: Tombol ⋯ untuk membuka menu OPTION.

7.1 Import Regency

Fitur Import digunakan untuk menambahkan data kabupaten/kota secara massal melalui file spreadsheet.

screenshot-291-import-menu-hover

Gambar 14: Menu OPTION terbuka menampilkan pilihan Refresh, Import, dan Export. Pilihan Import sedang diarahkan.

Klik Import untuk membuka dialog Import data.

screenshot-292-import-dialog

Gambar 15: Dialog Import data dengan area Drag & Drop/Browse, keterangan format file yang didukung, dan tombol Download untuk Template example.

Dialog Import data menampilkan:

Elemen Keterangan
Area Drag & Drop / Browse Area untuk menyeret file atau mengklik untuk membuka file browser
Format file File yang didukung: XLS dan XLSX
Template example / Download Tombol untuk mengunduh file template sebagai panduan format data yang benar

Langkah-langkah import regency:

  1. Klik ⋯ OPTION → pilih Import.
  2. Unduh Template example jika belum memiliki format file yang sesuai, lalu klik Download.
  3. Seret file XLS/XLSX ke area Drag & Drop, atau klik Browse untuk memilih file dari komputer.
screenshot-293-file-browser-select

Gambar 16: File browser untuk memilih file XLS/XLSX yang akan diimpor.

  1. Pilih file XLS/XLSX yang berisi data kabupaten/kota, lalu klik Open.
  2. Sistem akan memproses file secara otomatis.
screenshot-294-importing-notification

Gambar 17: Notifikasi "Importing data..." berwarna biru muncul saat proses import sedang berjalan di latar belakang. Klik notifikasi untuk melihat detail progres.

Catatan: Proses import berjalan di latar belakang. Notifikasi "Importing data... Process runs in the background." akan muncul selama proses berlangsung. Klik notifikasi tersebut untuk memantau detail progres import. Pastikan file menggunakan format template yang benar agar data dapat diimpor dengan tepat.

7.2 Export Regency

Fitur Export digunakan untuk mengunduh data kabupaten/kota ke dalam file spreadsheet Excel.

screenshot-295-export-menu-hover

Gambar 18: Pilihan Export pada menu OPTION.

Klik Export untuk membuka dialog Export data.

screenshot-296-export-dialog

Gambar 19: Dialog Export data dengan pilihan This page atau All page, tombol Cancel dan Export.

Dialog Export data menawarkan dua opsi cakupan data:

Opsi Keterangan
This page Mengekspor hanya data kabupaten/kota yang ditampilkan pada halaman aktif
All page Mengekspor seluruh data kabupaten/kota dari semua halaman

Langkah-langkah export regency:

  1. Klik ⋯ OPTION → pilih Export.
  2. Pilih cakupan data: This page atau All page.
  3. Klik tombol Export.
  4. Dialog Save As akan muncul untuk menentukan lokasi penyimpanan file.
screenshot-297-save-as-dialog

Gambar 20: Dialog Save As dengan nama file otomatis Regencies-YYYYMMDDHHMMSS.xlsx dan format Microsoft Excel Worksheet.

  1. Konfirmasi nama file dan lokasi penyimpanan, lalu klik Save.
screenshot-298-export-complete

Gambar 21: File hasil export tersimpan di komputer dengan nama Regencies-YYYYMMDDHHMMSS.xlsx.

Catatan: Nama file hasil export menggunakan format otomatis Regencies-YYYYMMDDHHMMSS.xlsx, di mana YYYYMMDDHHMMSS adalah timestamp saat file diekspor. File disimpan dalam format Microsoft Excel Worksheet (.xlsx).

8. Ringkasan Alur

Master Data → Applications → Regencies
│
├── [Lihat]       Daftar kabupaten/kota (Name | Province | Created at)
│                 Klik nama → Panel detail (ID, Province,
│                             Created at, Created by,
│                             Last modified, Last modified by, Close)
│
├── [Tambah]      + New regency → Panel Create new regency
│                 ├── Isi Name
│                 ├── Pilih Province (dropdown)
│                 └── Save → notifikasi "Data saved successfully"
│                           regency muncul di daftar
│
├── [Cari]        Search bar → ketik nama → daftar terfilter
│                 × → hapus filter → tampilkan semua
│
├── [Edit]        Hover baris → klik ✏ (Edit)
│                 → Panel Edit regency (field sama dengan Create)
│                 ├── Ubah field yang diperlukan
│                 └── Save → perubahan tersimpan
│
├── [Hapus]
│   ├── Satu item    → Hover baris → klik 🗑 (Delete)
│   │                → Konfirmasi "Delete Regencies" → Delete
│   │
│   └── Beberapa     → Centang checkbox beberapa baris
│       item         → Tombol "Delete item (N)" muncul
│                    → Klik Delete item (N)
│                    → Konfirmasi "Delete Regencies" → Delete
│
└── [Import/      ⋯ OPTION
    Export]       ├── Import → Dialog Import data
    │             │   ├── Drag & Drop / Browse file XLS/XLSX
    │             │   ├── Download Template example (jika perlu)
    │             │   └── Proses → notifikasi "Importing data..."
    │             │               (berjalan di latar belakang)
    │             │
    │             └── Export → Dialog Export data
    │                 ├── Pilih: This page / All page
    │                 ├── Klik Export
    │                 └── Save As → Regencies-YYYYMMDDHHMMSS.xlsx

9. Solusi dan Tindakan Selanjutnya

Masalah Kemungkinan Penyebab Solusi
Tombol + New regency tidak berfungsi Hak akses Administrator tidak mencukupi Hubungi Super Admin untuk memverifikasi hak akses pengelolaan Regencies
Dropdown Province tidak menampilkan pilihan Data Provinces belum tersedia di sistem Tambahkan data provinsi terlebih dahulu melalui modul Master → Applications → Provinces
Regency tersimpan tetapi tidak muncul di daftar Cache browser atau filter pencarian aktif Refresh halaman (F5 atau Ctrl+R); pastikan search bar kosong
Perubahan pada Edit tidak tersimpan Koneksi terputus atau tombol Save belum diklik Periksa koneksi jaringan; pastikan klik Save sebelum menutup panel
Regency tidak ditemukan saat pencarian Kata kunci tidak cocok dengan nama kabupaten/kota Periksa ejaan; klik × untuk mereset pencarian dan lihat seluruh daftar
Setelah dihapus, regency masih muncul Cache browser belum diperbarui Refresh halaman (F5 atau Ctrl+R) untuk memuat ulang daftar terbaru
Dialog konfirmasi Delete tidak muncul Koneksi lambat atau browser memblokir popup Refresh halaman dan coba kembali; pastikan browser mengizinkan dialog
File import ditolak Format file tidak didukung atau struktur data tidak sesuai template Gunakan format XLS/XLSX; unduh dan ikuti Template example yang disediakan
Proses import tidak selesai / data tidak masuk File berisi data tidak valid atau kolom tidak sesuai Periksa kembali isi file; pastikan semua kolom wajib terisi sesuai template
Notifikasi import tidak muncul Browser memblokir notifikasi atau koneksi lambat Izinkan notifikasi pada browser; periksa panel notifikasi aplikasi untuk memantau status import
File export tidak dapat dibuka File rusak atau format tidak kompatibel Pastikan aplikasi Microsoft Excel atau perangkat lunak kompatibel terinstal; coba export ulang

Dokumen ini dibuat untuk keperluan panduan internal Administrator aplikasi IdProo.

© 2026 IdProo — Hak Cipta Dilindungi